COMMENT ⊗   VALID 00002 PAGES
C REC  PAGE   DESCRIPTION
C00001 00001
C00002 00002	The WHO command (abbreviated W) runs the WHO program, which presents
C00024 ENDMK
C⊗;
The WHO command (abbreviated W) runs the WHO program, which presents
system status information at your terminal.  If you are at a Data
Disc or III display terminal, the information is displayed and
continually updated as long as the program continues to run.  If you
are not at a display, the information is typed out once.  The WHO
monitor command does not require that you be logged in. 

There are several commands which can be given to WHO to tell it what
information to present; these WHO commands are listed at the end of
this writeup.  On non-displays, WHO commands can only be given in the
monitor command line that runs WHO.  On displays, WHO commands can be
included in the monitor command running WHO and/or can be given
directly to WHO after it has started.  For example, the monitor
command line "WHO R<cr>" can be given at any terminal.  In a monitor
command line, any WHO command taking an argument (@*+-") must be the
last thing in the line (hence there can be only once such
argument-taking command in the monitor command line).  Any characters
in the monitor command line which are not legal WHO commands are
ignored.  Note that the character ";" is a WHO command (same as "↑")
and is NOT interpreted by WHO as delimiting a comment in the monitor
command line. 

From any terminal, the REENTER monitor command given with WHO will
cause the information to be sent to the line printer (LPT) instead of
to the terminal.  The information printed will be an updated version
of the information last typed out or displayed, or the complete set
of information if you have not yet started WHO; on displays, the
whole picture is printed, not just the part that fits on the screen. 


The first part of the WHO display is a list of the jobs on the
system, with various information about each job.  This list is
divided into two sections, for jobs belonging to users and for system
phantom jobs.  (More precisely, the second section contains jobs
which are detached and have the JLOG bit off in the job status word,
i.e., are not logged in.)  Jobs attached to pseudo-teletypes are
listed under the controlling job, with the line for the controlled
job indented.  The listing for each job has several parts:

  JOB      job number
  QUEUE    queue name, as in the WHO line, with possibly an extra
           character meaning one of several states (if more than one
           applies, the one listed first below is displayed):
	   ←  the job is in the JBTSIN list of jobs needed in core
           -  the job is now actually running
           ⊗  the job is locked in core
           →  the job's upper segment is about to be swapped in
           ↑  the job is next in line to be swapped out
           ↓  the job is next in line to be swapped in
           *  the job is swapped out
           ↔  the job is next in line to be shuffled (moved in core)
  PPN      the job's logged-in PPN
           (This will be 100100 for not-logged-in WHOs, etc.)
  LINE     the job's terminal line number, or DET for detached jobs
  JOBNAM   the job name
  SIZE     the job's core image size in K (1024-word blocks)
  TIME     the job's total run time since login
  PL       percentage of CPU time spent on this job recently
  SL       service level reservation for this programmer
  SEG      job number of this job's upper segment, if any
  SW10     number of ticks between startups of job's PDP-10
           spacewar module, if any
  SW6      number of ticks between startups of job's PDP-6
           spacewar module, if any
  ALIAS    the job's ALIAS PPN, if any (if a job has an ALIAS and is
           not running spacewar on either processor, a dot (.) will
           appear near the spacewar positions to help the viewer line
           up the ALIAS with the proper job line)


After the job display comes the information for upper segments,
containing the job number (possibly followed by one of the above
single-character markers), a "W" if the segment is not write
protected, the segment's job name, its core size, and the number of
jobs attached to the segment. 


The next part of the WHO display is a summary of overall system
statistics.  This includes: UPTIME--the time since the system was
last restarted; NULTIMES--short and long term time spent running the
null job; WASTED--short and long term time spent running the null job
when another job wanted to be run but wasn't in core; CORE--total
user core image sizes in core and swapped out; USABLE--the largest
contiguous free block of core, the total available user core not used
by locked-in jobs, and the total available user core; RUNNING
JOBS--the number of jobs in RUNQ and TQ and their combined core image
size; and TOTAL SLEVEL--the total service level reservation for
logged-in users. 


The final section of the WHO display is a list of all I/O devices in
use by programs or assigned by jobs.  For each such use of a device,
a line is displayed containing: the device's logical name, if any;
the device's physical name; the character "#" if the device was
assigned by the ASSIGN command; the number of the job using the
device; if a particular file is open, the file name, extension, and
directory ppn (for disk files), the number of records in the file,
the record currently being read or written, and the read/write status
of the file.  This last will be W if the file is open for output, R
if open for input, or RA if open in read-alter mode, followed by E if
the end of file has been read.  Note: if the file has been closed,
there may be no mode flags, and the number 1101 will appear in the
current-record position.  Record numbers are displayed in octal. 


			WHO COMMANDS

WHO accepts commands to determine what information is to be
presented.  These are single-character commands that should not be
followed by carriage return.  Some of these commands, however, must
be followed by an argument ended with a carriage return; ending such
an argument with an altmode will abort the command. 

On display terminals, only part of the information can fit on the
screen at a given time.  Certain commands provide "scrolling" of the
display up or down; these commands are ignored on non-displays.

The available commands are listed in the table below.  Other
characters will be ignored if appearing in a monitor command line
that runs WHO, but will make WHO clear the screen and exit if typed
to a WHO running on a display.  If no command is typed to a WHO
running on a display for 2 minutes, WHO will exit unless the "∞"
command (see below) has been given.  After WHO exits, whether by
command, by timing out, or by finishing the output on a TTY or the
LPT, typing the monitor command CONTINUE will cause it to restart and
to continue presenting on the terminal the same information it was
presenting when it exited. 

  Q        This is a legal command only on non-displays.  This causes
           the typeout to include only the PPN and TTY number for all
           jobs that are attached to a terminal.  Without the Q, WHO
           will type out the complete normal list of information
           described above. 
  ↑ (or ;) scroll up 1/2 screen (on displays only)
  ↓ (or :) scroll down 1/2 screen (on displays only)
  FF	   (formfeed) scroll up whole screen (on displays only)
  VT	   (vertical tab) scroll down whole screen (on displays only)
  0-9      repeat argument for following scrolling command: ↑;↓:FF VT
  ∞        run forever (otherwise WHO exits after nothing has been
           typed in for two minutes) (on displays only)
  R        only display jobs which have recently been Running
           (not in NULQ, STOP, IOWQ, or INTW)
  N        restore Normal display (all jobs)
  E        Exit, leaving information displayed on the screen with the
           page printer set up to avoid erasing it (on displays only)
  T        Type out the job information only.  This works on all
           terminals; on displays, it will exit after the typeout. 
  F        Same as T, but devices (F is for Files) are listed also.
           Both T and F omit the system statistics. 
  M V * "  These seven commands allow you to specify which jobs
  + - @    should be displayed.  WHO keeps two special tables of job
           specifications for deciding which jobs it will display;
           these tables are called the PLUS table and the MINUS
           table.  Jobs specified by the MINUS table will not be
           displayed (regardless of other conditions).  The PLUS
           table is ignored if empty; but if it is non-empty, then
           only jobs specified by the PLUS table are displayed;
           however, jobs specified by both tables will NOT be
           displayed, since the MINUS table has priority.  Both
           tables are initially empty and the R and N commands reset
           both tables to empty.  Jobs can be specified in these
           tables by project name, programmer name, project name and
           programmer name, job number, and job name.  Each of the
           commands * + - " @ takes an argument which should be ended
           with a carriage return; if an argument is ended with an
           altmode, the command will be aborted.  WHO will beep you
           if an argument is not accepted (illegal argument or
           aborted with altmode.)  The commands M and V take no
           argument.  The argument to @ is a filename, the argument
           to " is a job name, and the argument to each of the
           commands * + - is a job specification which can be any of
           the following forms:
             PRG      programmer name (letters and digits only)
             ,PRG     programmer name (letters and digits only)
             PRJ,     project name (letters and digits only)
             PRJ,PRG  project-programmer name (letters & digits only)
             NUMBER   a decimal job number less than 64 (digits only)
             "NAME    a job name (any sixbit characters after ")
           A job will match specifications of the first four types if
           either its logged-in PPN or its ALIAS PPN matches the
           specification.  Any job running on a PTY owned by a job
           being displayed will also be displayed, unless the job on
           the PTY matches a specification in the MINUS table.  If a
           job running on a PTY is displayed and its controlling job
           is not displayed, then the job on the PTY will be indented
           using dots (.'s) instead of spaces (which would be used if
           the controlling job were being displayed). 

           The seven individual commands are described below.

  M        only display jobs matching your logged-in programmer name
           or your ALIAS programmer name (clears both tables and then
           puts your logged-in programmer name and your ALIAS
           programmer name into PLUS table)
  V	   only display jobs belonging to volleyball players
           (simulates an @VB.DIS[P,DOC]--see @ below)
  *<spec>  only display jobs matching the specification <spec>
           (clears both tables and then puts <spec> into PLUS table)
  +<spec>  also display jobs matching <spec> except those matching
           entries in MINUS table (adds <spec> to PLUS table and re-
           moves it from MINUS table; leaves running-jobs-only mode)
  -<spec>  don't display jobs matching <spec> (adds <spec> to MINUS
           table and removes it from PLUS table)
  "<name>  only display jobs with the job name <name>
           (clears both tables and then puts <name> into PLUS table)
  @<file>  clear PLUS & MINUS tables and then put job specifications
           from the file <file> into the tables.  E directory pages
           and SOS line numbers are permitted and ignored.  The
           default extension .DIS is used if no extension is typed.
           If no PPN is typed, the disk area [P,DOC] is tried first,
           then your own disk area, to find the file. 

           In reading from a file:

           1) Spaces are ignored except in job names.
           2) A semicolon (;) not appearing in a job name causes the
           rest of the line to be ignored. 
           3) Non-sixbit characters (except lower-case letters, which
           are converted to upper case) are treated just like CRLFs. 

           An entry in the file can be any of the forms listed below,
           and should be terminated by a comma or a CRLF.  Note
           however that a comma (or any other sixbit character
           including semicolon and space) appearing as one of the
           first 6 characters of a job name will be taken as part of
           the job name. 
	     +<specx>	Add the specification <specx> to PLUS table.
	     <specx>	Add the specification <specx> to PLUS tabls.
	     -<specx>	Add the specification <specx> to MINUS table.
           Unless all entries in the file are of the form -<specx>,
           WHO leaves running-jobs-only mode (R).  A job
           specification in a file, <specx>, can be any of the
           following forms (note that these are slightly different
           from the forms for <spec> that you can type in):
	     PRG	programmer name
	     [PRG]	programmer name
	     [,PRG]	programmer name
	     [PRJ,]	project name
	     [PRJ,PRG]	project-programmer name
	     "NAME	job name.  After the " the first 6 characters
                        (or less if terminated by a CRLF) are taken
                        as a job name.  Then characters are skipped
                        until a comma or CRLF is seen.  
	   Note that you cannot specify a job number from a file.